home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / jh3b2of4.zip / JH3AUTO.TXT < prev    next >
Text File  |  1993-03-01  |  11KB  |  294 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                                                        │
  18.                                                 The Silicon Frog, Inc. │
  19.                                                                        │
  20.                                                       John Hancock 3.0 │
  21.                                                                        │
  22.                                                    The JH3AUTO Program │
  23.                                                                        │
  24.                                                            Version 1.0 │
  25.                                                                        │
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.             (c) 1988-92 The Silicon Frog, Inc.
  59.                 All Rights Reserved
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.             Table of Contents
  68.  
  69.  
  70.             Introduction...............................................1
  71.             How Duzzit Work?...........................................1
  72.             Installing the program.....................................2
  73.             Command-line Parameters....................................2
  74.                 The /TAG= parameter....................................2
  75.                 The /CF parameter......................................3
  76.                 The /CY parameter......................................3
  77.             Conclusion and Best Wishes.................................4
  78.  
  79.  
  80.  
  81.  
  82.  
  83.                                                           JH3AUTO Page 1
  84.  
  85.             Introduction
  86.  
  87.             JH3AUTO was released approximately two months after JH3 in
  88.             response to a number of JH3 users who expressed the need for
  89.             an automated tagline selector program.  As the program name
  90.             indicates, JH3AUTO is automatic.  As with any good camera,
  91.             however, the program's automatic features can be selectively
  92.             defeated.  But only up to a point.
  93.  
  94.             JH3AUTO assumes that JH3 has been installed on your system;
  95.             it relies on the presence of JH3 configuration files.  And,
  96.             if you're not a registered user, JH3AUTO will issue
  97.             reminders just like JH3, but with one major difference: you
  98.             are not charged for uses of JH3AUTO.  Reminders issued by
  99.             JH3AUTO only reflect the level of use of JH3 itself.  As a
  100.             result, if JH3AUTO is the only tagline selection program you
  101.             use, it will never issue reminder messages.  Since JH3AUTO
  102.             doesn't do a heck of a lot to begin with, I thought that a
  103.             show of generosity might provide an even stronger incentive
  104.             to register JH3.  I want your money, but I ain't gonna bash
  105.             you upside the head for it (although, with *some* folks,
  106.             head-bashing is the only thing that works when it comes to
  107.             registering shareware).
  108.  
  109.  
  110.             How Duzzit Work?
  111.  
  112.             JH3AUTO is very easy to use.  Unlike JH3, whose
  113.             configuration is customized via the JH3CFG program, JH3AUTO
  114.             is controlled entirely by command-line parameters.
  115.  
  116.             Some people do not like command-line parameters.  Others do
  117.             not like configuration programs.  And there's a third group
  118.             out there that doesn't like programs that can't read their
  119.             minds.  To make everybody happy, the next release of JH3AUTO
  120.             will be controlled by A) very large electrodes screwed
  121.             directly into your brain or B) very long probes you stick up
  122.             your nose.  Since I had to develop and test the system
  123.             myself, you will have to be able to think backwards and in
  124.             French.  Program bugs, if any, will manifest themselves as
  125.             massive electrical surges which may or may not result in
  126.             permanent damage to your cerebral cortex.  Such is the price
  127.             of progress, folks.  ßeta testers are encouraged to apply.
  128.  
  129.             JH3AUTO's purpose is to select tagfiles and taglines
  130.             automatically.  You may restrict the program to a single
  131.             tagfile, and you may also tell it program to *cycle* through
  132.             tagfiles, rather than to select taglines at random -- the
  133.             program's default M.O.  Finally, you can tell the program
  134.             that you want to confirm the choice, or merely see the
  135.             tagline that was selected.  In fully automatic mode, JH3AUTO
  136.  
  137.  
  138.  
  139.  
  140.  
  141.                                                           JH3AUTO Page 2
  142.  
  143.             requires absolutely NO command-line parameters and produces
  144.             no displays whatsoever -- it picks a tagfile and a tagline
  145.             completely at random.
  146.  
  147.  
  148.             Installing the program
  149.  
  150.             JH3AUTO must be defined to your reader in much the same way
  151.             as you defined JH3 itself -- of course, you must assign a
  152.             different activation key for JH3AUTO.  In addition, you may
  153.             wish to use some of the program's command-line parameters if
  154.             you do not want JH3AUTO to operate in totally automatic
  155.             mode.  These parameters are described next.
  156.  
  157.             *How* you install JH3AUTO in your mail reader depends
  158.             entirely on your mail reader -- see the INSTALL.TXT file
  159.             distributed with JH3; and use the same installation
  160.             procedure for JH3AUTO as you would for JH3 itself.  JH3AUTO
  161.             provides no inherent advantages to a mail reader which
  162.             already features a random or sequential tagline selection
  163.             method.  Of course, if your reader does not have this
  164.             feature, then you need JH3AUTO.
  165.  
  166.  
  167.             Command-line Parameters
  168.  
  169.             As with any other program, JH3AUTO's command-line parameters
  170.             follow the program's name in the reader's configuration
  171.             entry for the program:
  172.  
  173.             JH3AUTO  [/TAG=tagfile] [/CF]  [/CY] [/NS]
  174.  
  175.             Note that parameters can be specified in any order, but they
  176.             must be separated by at least one space.  JH3AUTO's command-
  177.             line parameter are not case-sensitive (i.e., "/cf" is the
  178.             same as "/CF").
  179.  
  180.  
  181.             The /TAG= parameter
  182.  
  183.             /TAG= lets you restrict JH3AUTO to a single tagfile.  You
  184.             need not specify the .TAG extension.  For example, to
  185.             restrict JH3AUTO to the JH.TAG file, you would use:
  186.  
  187.             JH3AUTO /TAG=JH
  188.  
  189.             If the /TAG= parameter is not used, JH3AUTO will pick a
  190.             tagfile at random.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                           JH3AUTO Page 3
  197.  
  198.             The /CF parameter
  199.  
  200.             /CF tells JH3AUTO to display a summary and confirmation
  201.             message before sending the tagfile to the reader program.
  202.             When this option is used, JH3AUTO display a summary screen
  203.             which includes the tagfile name, the tagline, its rank in
  204.             the tagfile, and a the following prompt:
  205.  
  206.             <Enter>=Accept  <Esc>=Cancel  R=Try Again
  207.  
  208.             Pressing <Enter> sends the tagline to the reader, while
  209.             <Esc> immediately terminates JH3AUTO without sending the
  210.             tagline to the reader.  Pressing R tells JH3AUTO to select a
  211.             different tagline (the confirmation screen will be displayed
  212.             again, of course).
  213.  
  214.             If you use the /CF parameter, you should also use the /NS
  215.             parameter.
  216.  
  217.             If you have "questionable" taglines, or taglines which
  218.             contain metastrings, use the /CF option so have an
  219.             opportunity to reject the selected tagline and ask JH3AUTO
  220.             to select a different one.  For example, if you are
  221.             messaging in the Feminism conference, you may wish to press
  222.             R when JH3AUTO picks:
  223.  
  224.                     "Until Eve arrived, this was a man's world"
  225.  
  226.             Similarly, you may wish to skip the following in the Mach